home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / CRS / crs05.d81 / gabv3.txt < prev    next >
Text File  |  2009-10-10  |  6KB  |  167 lines
  1.     GABventure System Documentation          Version 3.0   -   Mar 1987
  2.  
  3.  1. Introduction.
  4.  2. Features.
  5.  3. Future plans.
  6.  4. File conventions.
  7.  5. Prepare to play.
  8.  6. How to play.
  9.  7. How to make a GABventure.
  10.  8. Known bugs.
  11.  9. Feedback.
  12.  
  13.  
  14.  Section 1 - Introduction
  15.  
  16.     GABventure is a text-adventure      system for the C64.  You can play or
  17. write adventures.  BASIC programs are   used but you don't program to write
  18. adventures.  More on that later.
  19.  
  20.     Written entirely by Gary A. Beck
  21.  
  22.     THIS SYSTEM IS PUBLIC DOMAIN.
  23.  
  24.  
  25.  Section 2 - Features
  26.  
  27.  1. Command/Abbr
  28. north/n   south/s   east/e    west/w    up/u      down/d    enter     exit
  29. get       drop      open      close     lock      unlock    look/l    examine
  30. quit/q    stop      end       read      inventory/i         score     help
  31. put....into....     get....from....     turn on   turn off  printer   what
  32.  
  33.  2. Some objects can contain other      objects or GABventurers.
  34.  3. GABventurers can carry objects.
  35.  4. Moving to some locations may requireyou to be inside of a 'vehicle' or have
  36. 'equipment' with you.
  37.  5. Full description of 'rooms' is      provided on initial entry or by
  38. 'look'ing around.
  39.  6. The game is over when the maximum   score is 'score'ed.
  40.  7. You can play again after 'quit'ing  without reloading the program.
  41.  8. SAVE option when 'quit'ing.
  42.  9. RESTORE option at the start.
  43. 10. Output to printer via 'printer' cmd
  44. 11. You can 'get/drop/what' a list of   objects: 'get chain tree fish'
  45. 12. New versions of GABventure are able to play GABventure games created for
  46. previous versions. (That's half the     reason for the OPT file.)
  47.  
  48.  
  49.  Section 3 - Future Plans
  50.  
  51.     Addition of CHARACTERS to interact  with.  The current version does get
  52. lonely now and then.
  53.  
  54.     Maintain clock.
  55.  
  56.  (Your comments could add to this list)
  57.  
  58.  
  59.  Section 4 - File Conventions
  60.  
  61.     GABventure system uses disk files   in addition to the program itself.  You
  62. will need the proper collection of      files to play a game.
  63.  
  64.     File names will follow this         convention:
  65.     The first three characters are GAB  - in upper case.
  66.     Characters four through six identify either a game or version number.
  67.     Character seven is a period.
  68.     Characters eight through ten are        the file type - in upper case.
  69.  
  70.     Files used by GABventure:
  71.   NAME     P/S/R/U  Used for...
  72.  
  73. GABnnn.PLY    P     Playing the game
  74. GABnnn.BLD    P     Make your own
  75. GABnnn.STR    P     Make RELative file  from SEQuential file (or SEQ from REL)
  76. GABnnn.REL    R     These are the rooms or places.  Used to play the game.
  77.                     You build one to    make your own GABventure.
  78. GABnnn.SEQ    S     Tis a SEQuential    version of the RELative file.
  79.                     You can use the STR program to make the REL file from this.
  80. GABnnn.OBJ    S     These are the       OBJects.  Needed to play.  Build one to
  81.                     make your own.
  82. GABnnn.OPT    S     The OPTions for     GABventure nnn.  Used to Play the game.
  83. GABnnn.DOC    S     You are reading it.
  84. GABnnn.SAVxxx S     Saved game position
  85.  
  86. By the way, P/S/R/U stands for PROGRAM  SEQUENTIAL RELATIVE USER.  These are
  87. file storage types.
  88.  
  89.  
  90.  Section 5 - Prepare to Play.
  91.  
  92. You need four files to play.
  93. GABnnn.PLY is the program.  The other   three files are OPT, REL, OBJ.
  94. The names of these three files must     follow the naming conventions outlined
  95. in section 4. (If not, it won't work.)
  96.  
  97. So...for GABventure number 007 ya need: GAB007.OPT   GAB007.REL   GAB007.OBJ
  98.  
  99. Note: UPPERCASE is needed and the files MUST be of the proper storage type.
  100.  
  101. Check your directory.  Are the needed   files there?  If so go to section 6.
  102.  
  103. Was only REL missing?  If so -  you can make one if you have the SEQ file.
  104.  
  105. LOAD & RUN the GABnnn.STR.
  106. It will ask you for the GABventure      number.  Enter the three characters.
  107. The program will first read the options from the OPT file.  Then the SEQ file
  108. is read.  Finally the REL file is made. Creating the REL file is rather slow.
  109. Maybe you could read a good book while  you wait.
  110.  
  111. You should now have all the files you   need.  If not you need more help than I
  112. can give you here - seek help elsewhere.
  113.  
  114.  Section 6 - How to Play
  115.  
  116.     To play you need the PLY, OPT, OBJ  and REL files.  That's all covered in
  117. section 5 above.
  118.  
  119.     LOAD GABnnn.PLY
  120.     RUN  it.
  121.     This is basic. Do your normal thing.
  122.     You will be asked what drive number the data is on.  Default is 8.
  123.     You will be asked which GABventure  to play.  This is a three character
  124. identifier. (The one that comes after   GAB in the OPT, OBJ and REL file names)
  125. Enter all three characters. You should  be off and running.
  126.  
  127.  
  128.  Section 7 - How to make a GABventure
  129.  
  130.     You need the GABnnn.BLD program for this.
  131.     Using the BLD program you can make  or modify the OPT, OBJ & REL files.
  132.     Positive locations are rooms or     places. Negative locations are objects. Location zero is the GABventurer.
  133.     If object 2 is located inside of    object 5 then its location is -5.
  134.     If object 7 is in room 3 then its   location is 3.
  135.     If the GABventurer has object 10    then its location is 0.
  136.     You can define TRIPs.  A trip is a  range of room numbers which require
  137. certain object number(s) to be held by  the GABventurer.  Set trips up while  
  138. editing the OPT file.
  139.     Beyond that it's self explanatory.
  140.     In the future the program and this  document will be revised based on your
  141. comments.
  142.  
  143.  
  144.  Section 8 - Known Bugs & FUNNY Stuff
  145.  
  146.     I wrote it so it makes sense to me  but you .... might have other ideas.
  147.  
  148. Details:
  149.   When naming objects in commands, you  match on all characters or ending
  150. characters of the object name.          If more than one match... strangeness.
  151. If an object name is more than one word you should use only one of them in
  152. commands.
  153.   You can exit and re-enter an object   while using it as a vehicle.
  154.  
  155.  
  156.  Section 9 - Feedback
  157.  
  158.     By mail: G. A. Beck
  159.              5419 Summit
  160.              Lyndhurst, OH  44124
  161.  
  162.     CIS:     73537,3704
  163.  
  164.  
  165.  
  166.  
  167.